Stdlib/<K, V>

<K, V>

map <K, V>

Methods

pub fn clone(self): <T, T>

Shallow copy a map.

let items = {
  "name": "Peter",
};

let items2 = items.clone();
items2["name"] = "Jason";

assert_eq items["name"], "Peter";
assert_eq items2["name"], "Jason";

pub fn values(self): [T]

Return all values in the map.

let items = {
   "name": "Peter",
   "age": "20",
   "country": "US",
};

assert_eq items.values(), ["Peter", "20", "US"];

pub fn keys(self): [T]

Return all keys in the map.

let items = {
   "name": "Peter",
   "age": "20",
   "country": "US",
};

assert_eq items.keys(), ["name", "age", "country"];

pub fn clear(self)

Remove all elements from the map.

let items = {
  "name": "Peter",
  "age": "20",
};
items.clear();
assert_eq items.len(), 0;

pub fn remove(self, key: T)

Remove a key from the map. If the key does not exist, this function does nothing.

let items = {
   "name": "Peter",
};

items.remove("name");
assert_eq items.len(), 0;
items.remove("name"); // does nothing

pub fn set(self, key: T, value: T)

Set a key-value pair into the map.

If the key already exists, the value will be replaced.

let items: <string, string> = {:};
items.set("name", "Peter");
items.set("age", "20");

items.len(); // 2
items.set("age", "21");
items.len(); // 2

Or you can just use the [] operator:

let items: <string, string> = {:};
items["name"] = "Peter";
items["age"] = "20";

pub fn get(self, key: T): T?

Get a value from the map.

If you use get will return a tuple (value, true) if the key exists, otherwise (nil, false).

let items: <string, string> = {:};
items.set("name", "Peter");
items.set("age", "20");
items.get("name"); // "Peter", true

Or use the [] operator, this will just return the value, if the key does not exist, it will return nil.

nv,

items["name"]; // "Peter"
items["not-exist"]; // nil

pub fn contains_key(self, key: T): bool

pub fn is_empty(self): bool

pub fn len(self): int